home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / tmod620.zip / TMODEM.DOC < prev    next >
Text File  |  1991-06-28  |  44KB  |  1,189 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                                    Tmodem
  31.                                  Version 6.20
  32.                           (C) Copyright 1989,90,91
  33.                                   Mike Bryeans
  34.                               All Rights Reserved
  35.  
  36. Tmodem Command Line Switches .............................. Page   1
  37.      /S ................................................... Page   1
  38.      /R ................................................... Page   2
  39.      /U ................................................... Page   2
  40.      /F ................................................... Page   3
  41.           NOTE To WildCat! Sysops ......................... Page   3
  42.      /K ................................................... Page   4
  43.      /N ................................................... Page   4
  44.      /P ................................................... Page   4
  45.      /B ................................................... Page   5
  46.           12000/14400 Connect Messages .................... Page   5
  47.      Locked DTE/BBS programs .............................. Page   6
  48.           Locked DTE/WildCat! ............................. Page   6
  49.      /X ................................................... Page   7
  50.      /@ ................................................... Page   7
  51.           PCboard Sysops .................................. Page   8
  52.      /A ................................................... Page   8
  53.      Required Switches .................................... Page   9
  54.      Your Receive Batch File .............................. Page   9
  55.      Send Batch File ...................................... Page  10
  56. Error Levels .............................................. Page  10
  57. Debug Messages ............................................ Page  10
  58. BBS/Terminal Programs ..................................... Page  10
  59. Installation Setup and Debugging Tips ..................... Page  11
  60. Installing Tmodem on A BBS ................................ Page  11
  61. Installing Tmodem on a Terminal Package ................... Page  12
  62. Terminal Interface Examples ............................... Page  14
  63.      Telix ................................................ Page  14
  64.           Locked Serial Ports and Telix ................... Page  14
  65.      Qmodem ............................................... Page  15
  66.      QT 2000 .............................................. Page  16
  67. Pcboard ................................................... Page  16
  68.      (PCBRT.BAT) .......................................... Page  16
  69.      (PCBST.BAT) .......................................... Page  16
  70. SpitFire BBS .............................................. Page  16
  71.      (SFEXTUPB.BAT) ....................................... Page  17
  72.      (SFEXTDNC.BAT) ....................................... Page  17
  73.      (SFEXTDND.BAT) ....................................... Page  17
  74.      (SFEXTUP.BBS) ........................................ Page  18
  75.      (SFEXTDN.BBS) ........................................ Page  18
  76. LIMITED SHAREWARE. ........................................ Page  18
  77.      Features that will not work. ......................... Page  18
  78.           Batch  Downloads ................................ Page  18
  79.           Restart Recover ................................. Page  18
  80. Registering Tmodem ........................................ Page  18
  81.      $15.00 Registration .................................. Page  19
  82.      $25.00 Registration .................................. Page  19
  83. Tmodem License ............................................ Page  19
  84.  
  85.                              LIMITED WARRANTY
  86.  
  87.          This  product  is provided "as is" without  warranty  of  any
  88.          kind.   The entire risk as to the results and performance  of
  89.          the  program  is assumed by you.  Should  the  program  prove
  90.          defective,  you (and not Mike Bryeans) assume the entire cost
  91.          of all necessary  servicing, repair or corrections.
  92.  
  93.          Mike Bryeans does NOT warrant,     guarantee,     or     make
  94.          representations  regarding the use of, or the results of  the
  95.          use  of  this program in terms of  correctness,     accuracy,
  96.          reliability,   currentness,    or otherwise;  and  you   rely
  97.          on  the  program  and  it's  results solely    at   your  own
  98.          risk.   Mike Bryeans can not accept responsiblity for  system
  99.          , loss  of profit,  or   any  other  special,  incidental, or
  100.          consequential  damage resulting  from the use or  inablity to
  101.          use   this product.
  102.  
  103.                        DISTRIBUTION POLICY AND COPYRIGHT
  104.  
  105.                                    COPYRIGHT
  106.  
  107.          Regardless  of the method of marketing, Tmodem is not in  the
  108.          public    domain.    It  is  copyrighted  by Mike Bryeans.
  109.  
  110.          Copying,   duplicating, selling   or   otherwise distributing
  111.          this  product  except  as expressly   permitted in the TEST-
  112.          DRIVE  Distribution  Policy below  is a violation of the law.
  113.  
  114.          However, you  are  granted the  right,   in  fact  encouraged
  115.          to make and distribute as   many  copies   of this TEST-DRIVE
  116.          version as you  wish, using any acceptable medium of exchange.
  117.          With the following provisions:
  118.  
  119.                      -- TEST-DRIVE Distribution Policy --
  120.  
  121.           1.   Please feel free to distribute this TEST-DRIVE version as
  122.                often as you like, to any interested parties.
  123.           2.   Please do not distribute the program without all of its
  124.                original related files, addendum files, and documentation.
  125.           3.   Please obtain our written permission prior to distribution
  126.                with any "Bundled" software packages.
  127.           4.   Please do not accept payment for the program; a copying fee of
  128.                $10.00 per diskette may be charged when distributed by a
  129.                non-profit user-group.
  130.           5.   Please do not alter the program or documentation in any
  131.                manner.
  132.           6.   NOTE - Individuals, groups, vendors, or other software
  133.                distribution companies which market diskettes containing
  134.                the TEST-DRIVE programs for profit must obtain written
  135.                permission prior to distribution.
  136.  
  137.          Tmodem v6.20                                          Page  1
  138.                           Tmodem Command Line Switches
  139.  
  140.          Each  switch must be preceded by either a forward slash   '/'
  141.          or a dash '-'.
  142.  
  143.          S   Slow Computer.
  144.          R   Receive File.
  145.          U   Place incoming files in this directory
  146.          F   Send these files
  147.          K   Keep aborted transfers
  148.          N   Node Number caller is on.
  149.          P   Com Port to use.
  150.          B   Connect Baud Rate
  151.          X   Turn log OFF
  152.          @    Name of text file containing names of files to  send.
  153.          A    Calibrate  Serial  Port.
  154.          C   Cancel Error/Suggestion Screens.
  155.  
  156.                                       /S
  157.                               9600 bps and higher
  158.                                  Slow Computer
  159.  
  160.          If  you have a high speed modem you MUST have a  16550  Uart.
  161.          Attempting  to run at high speeds without one will result  in
  162.          errors.
  163.  
  164.          Some  computers may, if they are fast enough, sneak by.  Most
  165.          will not.
  166.  
  167.          A good way to check is by watching your transfers. If you are
  168.          under  an  error correcting connect, then you  should  almost
  169.          NEVER get an error reported by ANY transfer protocol.
  170.  
  171.          Getting  errors  reported (by ANY  transfer  protocol)  while
  172.          under  MNP  or  ARQ  can only mean.
  173.  
  174.          1.  The protocol goofed (Tmodem doesn't goof).
  175.          2.  You  may  have some other  application  interfering  with
  176.              serial interrupts.
  177.          3.  You have hardware problems.
  178.          4.  You do not have a 16550 Uart.
  179.  
  180.  
  181.          Since you are using Tmodem, you can rule out # 1.
  182.  
  183.          If you have a 16550 installed, then you can rule out # 4  and
  184.          that leaves you with 2 or 3.
  185.  
  186.          If you have a multi-tasker or a network and a 16550 then  the
  187.          network and/or multi-tasker is stealing to much time and  the
  188.          16550 fifo's are being over run.
  189.  
  190.          Tmodem v6.20                                          Page  2
  191.  
  192.          If you have a 16550 and NOTHING else that may interfere  with
  193.          the  serial  interrupts,  then  you  more  than  likely  have
  194.          hardware problems.
  195.  
  196.          If  it is option 4, buy one and install it. 16550 uarts  cost
  197.          about 20 dollars and are WELL worth it.
  198.  
  199.          Unless  you  have hardware problems, we can HELP you  out  by
  200.          kicking  in RTS flow control. This does slow down  transfers,
  201.          but it is better to slow them DOWN than experience errors.
  202.  
  203.          If  you have to, add /S to the command line. But only use  it
  204.          if  you  HAVE  to and only until you fix  the  CAUSE  of  the
  205.          problem.
  206.  
  207.                                      /R
  208.                                  Receive Files
  209.  
  210.  
  211.          When   I  encounter  this switch, I  will  go   directly   to
  212.          Receive files mode.
  213.  
  214.          You  MUST make sure that /R is the very last switch used.  If
  215.          it  is not, then you will be missing important  command  line
  216.          switches.
  217.  
  218.                                       /U
  219.                      Place inbound files in this directory
  220.  
  221.          You  can direct Tmodem to place inbound files in  a  specific
  222.          directory by using the /U command.
  223.  
  224.          I will verify the directory you specified, so make sure it is
  225.          a VALID directory.
  226.  
  227.          You  can not use Drive  designators or ROOT directories  with
  228.          the /U switch.
  229.  
  230.          For  instance,   /UC:  or  /UC:\ are not valid  because  they
  231.          have no directory listing and I can not validate them.
  232.  
  233.          You  must also make sure you do NOT use a trailing  backslash
  234.          with  the /U path. I will ADD a backslash when I concate  the
  235.          file name with the path you specified.
  236.  
  237.          e.g. d:\uploads\ is NOT valid.
  238.  
  239.          It should be d:\uploads
  240.  
  241.          Here is a sample of a GOOD /U setting:
  242.  
  243.          /UC:\TELIX\UPLOADS
  244.  
  245.          Tmodem v6.20                                          Page  3
  246.  
  247.                                       /F
  248.                                Send These Files
  249.  
  250.          When  I  find the /F, I will immediately  begin  sending.
  251.  
  252.          YOU  should  make  sure that you have listed  ALL  the  OTHER
  253.          commands before using the /F.
  254.  
  255.          Make sure you place ONE blank space between the /F switch and
  256.          the filename that follows it.
  257.  
  258.          Also place one blank space between ADDITIONAL files names  IF
  259.          you have specified more than one.
  260.  
  261.          You may include a drive and path with the file names.
  262.  
  263.          For  instances,  c:\uploads\file1.exe is  a  perfectly  valid
  264.          file name.
  265.  
  266.          You may also use the DOS wild card characters '?' and '*'.  I
  267.          will  expand  those  characters to match  any  file  in  that
  268.          directory.
  269.  
  270.  
  271.          I  do  not place any limits on the number of files  that  can
  272.          FOLLOW /F, but DOS DOES!
  273.  
  274.          DOS  restricts  the number of characters you can place  on  a
  275.          command line to 128.
  276.  
  277.          DOS  also limits you to 9 batch parameter symbols,   %1  thru
  278.          %9.
  279.  
  280.                             NOTE To WildCat! Sysops
  281.  
  282.                    Some   versions  of   WildCat!   do   not
  283.                    correctly passing the  names of the files
  284.                    to  send.  *IF*  you  tell  WildCat!  the
  285.                    protocol is  a BATCH protocol.
  286.  
  287.                    In this case, it sends only the NAMES  of
  288.                    the files, but does NOT send the location
  289.                    of the files.
  290.  
  291.                    For instances, TMOD610.EXE  would be  the
  292.                    only  thing  WildCat!  sends. TMOD610.EXE
  293.                    may  be on Drive Q, F, or G.It ma  be  in
  294.                    any  sub-directory on  any  one of  those
  295.                    drives.  It more or less  says   "Hey....
  296.                    find  this  file... it's on the  computer
  297.                    SOMEPLACE  and  send it".
  298.  
  299.          Tmodem v6.20                                          Page  4
  300.  
  301.                    Mustang   Software  was  contacted  about
  302.                    this,  but  flat  denied  that   WildCat!
  303.                    did it. Don't know why they bothered   to
  304.                    lie  about   it. A dozen  WilCat!  sysops
  305.                    verified it.
  306.  
  307.                    We  could  fix that, but the  FIX  is  to
  308.                    complex for the average person.
  309.  
  310.                    If  you have a version of  WildCat!  that
  311.                    does  this,  you can only use  Tmodem  in
  312.                    NON-BATCH mode.
  313.  
  314.                                       /K
  315.                             Keep Aborted Transfers
  316.  
  317.          If  you  drop  carrier, time out, or  something  along  those
  318.          lines, I will delete the aborted file.
  319.  
  320.          If  you  are using Tmodem with a TERMINAL program,  then  you
  321.          will WANT to keep the file.
  322.  
  323.          Adding  /K to your Tmodem command line will tell ME that  you
  324.          want those files kept.
  325.  
  326.                    NOTE:  I will not keep aborted  files  if
  327.                    you manual abort using the ESC key,  even
  328.                    if you DO use /K.
  329.  
  330.                                       /N
  331.                                   Node Number
  332.  
  333.          If  you  are running OSIRIS SE, you can include  /Nx  on  the
  334.          command line.
  335.  
  336.          e.g. /N1  /N2  /N3 ... /N255
  337.  
  338.          Add /N*N to your protocol command lines.
  339.  
  340.          I  will  display the callers name, city, and  state  at   the
  341.          bottom of the screen if you provide the node number. This can
  342.          be very useful when you walk into the room and WONDER who  is
  343.          currently downloading what.
  344.  
  345.                                       /P
  346.                                    Com Port
  347.  
  348.          You have to tell me which serial port you want Tmodem to use.
  349.  
  350.          You  do  this by including /Px on the command line.
  351.  
  352.          e.g. /P1  /P2  /P3 ... /P8
  353.  
  354.          Tmodem v6.20                                          Page  5
  355.  
  356.          Only P1 though P4 are valid for NON-Osiris SE systems.
  357.  
  358.          If  you are  using Osiris, you  can  use  /P5 though /P8.
  359.  
  360.                                       /B
  361.                                Connect Baud Rate
  362.  
  363.          I  REQUIRE that you provide the TRUE CONNECT RATE.   Most  of
  364.          the time this is the same as your SERIAL baud rate.
  365.  
  366.          e.g. /B1200  /B2400  /B9600
  367.  
  368.          For those of you running 300, 1200, and 2400 bps modems, skip
  369.          the remainder of this section. It does not pertain to you.
  370.  
  371.          The only time that it would NOT be the same is if you have  a
  372.          high speed  modem with a FIXED serial rate. In  which   case,
  373.          the CONNECT rate will  not  always  be  the SERIAL rate.  But
  374.          that  doesn't change anything. You still must pass  the  TRUE
  375.          connect rate and not the SERIAL rate.
  376.  
  377.          If your terminal program isn't capably of passing the CONNECT
  378.          rate then HARD CODE 0 in as the /B parameter.
  379.  
  380.          e.g. /B0
  381.  
  382.          I will then PROMPT you for the CONNECT rate.
  383.  
  384.                           12000/14400 Connect Messages
  385.  
  386.          There is a little confusion about these connect messages.
  387.  
  388.          They are NOT valid CONNECT RATES.
  389.  
  390.          A VALID connect rate MUST be a baud rate the SERIAL port  can
  391.          be  SET TO.
  392.  
  393.          The  Serial port can not and will not accept 12000  or  14400
  394.          settings.
  395.  
  396.          If the software you are using to answer the phone allows  you
  397.          to define the CONNECT baud rate. ISIS does. then define  9600
  398.          pbs  as  the  connect rate for the 12000  and  14400  connect
  399.          messages.
  400.  
  401.          If the software does not, then you must turn off the extended
  402.          connect  codes. The US Robotics 14.4 and Dual  Standards  use
  403.          &A1 to disable the extended codes.
  404.  
  405.          Most  programs will use a LOOKUP table to validate  the  baud
  406.          rate  you  pass them. 12000 and 14400 will generally  not  be
  407.          found and if the program does any type of error trapping,  it
  408.          will not run.
  409.  
  410.          Tmodem v6.20                                          Page  6
  411.  
  412.          Some  programs will convert the 12000 and 14400 to 9600,  but
  413.          those programs are few and far between.
  414.  
  415.          And  some programs don't care what you pass them.  They  will
  416.          attempt to open the serial port without validating the  rate.
  417.          If you are running a locked DTE, then you can squeak by since
  418.          it  opens at the LOCKED DTE instead of the baud rate  passed.
  419.          If  that program happens to be a BBS, then it will  pass  the
  420.          invalid  serial rates to external programs and if they  don't
  421.          support the auto-conversion... you can have a system lockup.
  422.  
  423.                             Locked DTE/BBS programs
  424.  
  425.          If   you  are setting up Tmodem as an external  BBS  protocol
  426.          and your  BBS can't pass the TRUE CONNECT rate, you will have
  427.          to  setup THREE protocol definitions. One  for   1200,  2400,
  428.          and  one  for high speeds.
  429.  
  430.                               Locked DTE/WildCat!
  431.  
  432.                    Wildcat! is one of the BBS programs  that
  433.                    pass  the LOCKED DTE rates.  However,  it
  434.                    LOGS  the connect rate in it's  BBS  Log.
  435.  
  436.                    By  using the WildCat! log, we can  do  a
  437.                    conversion  so  that you do NOT  have  to
  438.                    use three different batch files.
  439.  
  440.                    Included   within  the  Tmodem   archive,
  441.                    you    will    find   a    file    called
  442.                    "WILDCAT.EXE".
  443.  
  444.                    This  is a self extracting  archive  that
  445.                    contains the information needed to  setup
  446.                    Tmodem with WildCat.
  447.  
  448.          I  am  sorry, but there simply is not anything that  I   can
  449.          do  about that.
  450.  
  451.          Tmodem  is a "SMART" protocol that configures  each  transfer
  452.          according to the computer's speed,  modem  hardware,  connect
  453.          rate, and line noise for each transfer.
  454.  
  455.          Only  the  BBS or Terminal program can  supply  the   CONNECT
  456.          rate. It can't be READ from any other FIXED location.
  457.  
  458.          The   next  thing  you  will need to  do,  is   to  define  a
  459.          environment   variable  called COMx=BaudRate. Replace x  with
  460.          the  serial port  number  and BaudRate with the  LOCKED  baud
  461.          rate.
  462.  
  463.          e.g. COM1=19200
  464.  
  465.          Tmodem v6.20                                          Page  7
  466.  
  467.          Do  NOT add blank spaces or comma's. Make sure you use  Upper
  468.          Case.
  469.  
  470.          You can do that in the AUTOEXEC.BAT file or in the BATCH file
  471.          you use to CALL Tmodem.
  472.  
  473.          e.g.
  474.  
  475.          cls
  476.          Echo Loading Tmodem
  477.          SET COM2=38400
  478.          Tmodem -B%1 -P%2 -R
  479.          echo Transfer Complete.
  480.          Exit
  481.  
  482.          Tmodem can support up to 115,000 baud using the combined COMx
  483.          and /B switch.
  484.  
  485.                                       /X
  486.                                  Turn off Log
  487.  
  488.          I will write a TRANSFER log called Tmodem.Log in the  current
  489.          directory.  If I find OSIRIS= defined in the  environment,  I
  490.          will write the log in that directory.
  491.  
  492.          If  you  do not want the me to LOG the transfers, add  /X  to
  493.          your command line.
  494.  
  495.                                      /@
  496.              Name of text file containing names of files to send.
  497.  
  498.          e.g. /@D:\OSIRIS\SEND2.CTL
  499.  
  500.          Since  DOS forces me to work with only 128 characters  and  9
  501.          batch  variables,  so  using /@ to send  file  names  is  the
  502.          preferred over /F.
  503.  
  504.          The information following the @ is the full drive, path,  and
  505.          file name of a TEXT file.
  506.  
  507.          The TEXT file should contain the names of the files to send.
  508.  
  509.          I  do not place any restrictions on the number of files  that
  510.          you  can  have listed. You can also include the  full  drive,
  511.          path, and name of the file.
  512.  
  513.          For instances, C:\PCboard\Tlx310a.exe is valid.
  514.  
  515.          You  can  also include the DOS wild card characters  '*'  and
  516.          '?'.
  517.  
  518.          c:\pcboard\*.arj is a valid listing.
  519.  
  520.          Tmodem v6.20                                          Page  8
  521.  
  522.          Each line in the file must contain only ONE filename and  has
  523.          to end with the DOS CR/LF sequence.
  524.  
  525.          As  SOON  as I find the /@ switch, I will begin to  send  the
  526.          files  listed in the TEXT control file. Therefore,  you  must
  527.          make  sure  that /@ is the very LAST switch  on  the  command
  528.          line.
  529.  
  530.          Sample TEXT Send Control File:
  531.  
  532.          C:\DRIVERS\MPT110.ZIP
  533.          C:\DRIVERS\TMOD610.ARJ
  534.          C:\DRIVERS\ZMOD*.*
  535.  
  536.          You MUST NOT intermix the -F and -@. You can use either  one,
  537.          but not BOTH at the same time.
  538.  
  539.                                 PCboard Sysops
  540.  
  541.                    Some   versions  of Pcboard will  attempt
  542.                    to intermix  the  two formats.  In  other
  543.                    words,  sometimes  Pcboard  will   simply
  544.                    pass the  filenames,  sometimes  it  will
  545.                    pass   @LISTNAME  and  it includes  @  as
  546.                    part of the filename making it impossible
  547.                    for  you to configure a BATCH  file  that
  548.                    will work.
  549.  
  550.                    If you attempted to do a /F %3 %4 %5 with
  551.                    Pcboard,   you  may  get  a   send   then
  552.                    again  Pcboard   may  decide   to   place
  553.                    @D:\PCBOARD\SEND.CTL   in  %3.  In  which
  554.                    case,  I will  SEND that file instead  of
  555.                    using  it because  it followed   the  /F,
  556.                    indicating  that  it was a  file  to   be
  557.                    sent.
  558.  
  559.                    I have included a self extracting archive
  560.                    called  PCB.EXE.  This file  contains  an
  561.                    interface   to  STABILIZE   the   Pcboard
  562.                    command line for Tmodem. Extract and read
  563.                    the  instructions contained  within  that
  564.                    archive.
  565.  
  566.                                       /A
  567.                              Calibrate Serial Port
  568.  
  569.          Some  IBM  XT's and IBM AT's with older ROM's  have  problems
  570.          dealing  with  high speed modems with LOCKED DTE rates.
  571.  
  572.          Normally   this  doesn't cause problem,   but   since  Tmodem
  573.          customizes the way it sends, it does.
  574.  
  575.          Tmodem v6.20                                          Page  9
  576.  
  577.          /A   tells me to calibrate the serial port and if it is  off,
  578.          make the needed internal adjustments.
  579.  
  580.          This ONLY works on IBMs (not clones).
  581.  
  582.          HOWEVER,  one  of  the  side  effects  is  the  detection  of
  583.          inaccurate  command line switches. Not all of them, but  some
  584.          of them.
  585.  
  586.          If  you  have problems getting Tmodem to work you  might  TRY
  587.          adding this switch, even if you do NOT have an IBM.
  588.  
  589.                                Required Switches
  590.  
  591.          Each  Tmodem installation will require TWO switches. It  does
  592.          not matter  what type of BBS/Terminal program you're going to
  593.          be  using.
  594.  
  595.          It does not matter if it's SENDING or RECEIVING.
  596.  
  597.          /Bxxxxx and /Px
  598.  
  599.          You  should  replace   xxxxx  in  the /B  with   the  correct
  600.          CONNECT rate or 0. Replace the x in /P with  the correct  COM
  601.          port.
  602.  
  603.          /B9600 /P2  (Connect Rate 9600, COM 2)
  604.          /B2400 /P1  (Connect Rate 2400, COM 1)
  605.  
  606.          It is not important WHERE you place the switches, As long  as
  607.          they are NOT the LAST switch used.
  608.  
  609.                             Your Receive Batch File
  610.  
  611.          Your  Receive  Batch file will require  only  one  additional
  612.          switch, /R.
  613.  
  614.          It MUST be the very last switch on the command line.
  615.  
  616.          The  MINIMUM command line for receiving would be:
  617.  
  618.          Tmodem /B2400 /P1 /R
  619.  
  620.          The  2400 and the 1 may  be supplied by DOS batch variables.
  621.  
  622.          e.g. Tmodem /B%1 /P%2 /R
  623.  
  624.          They may be supplied by any other means at your disposal.
  625.  
  626.          Other  optional  switches (/U for instants) may  be  included
  627.          BEFORE the /R switch.
  628.  
  629.          Make sure there is at LEAST one space between switches.
  630.          Tmodem v6.20                                          Page 10
  631.  
  632.                                 Send Batch File
  633.  
  634.          Your SEND batch file only requires one additional switch:
  635.  
  636.          /F
  637.          or
  638.          /@
  639.  
  640.          Either switch MUST be the last switch on the command line.
  641.  
  642.          The MINIMUM command line for sending a file:
  643.  
  644.          /B2400 /P2 /F FILENAME#1 FILENAME#2 FILENAME#3
  645.  
  646.          or
  647.  
  648.          /B2400 /P2 /@CTRL_NAME
  649.  
  650.          The  2400, 2, FILENAME#1, FILENAME#2,  FILENAME#3,  etc.  may
  651.          be supplied by  DOS  batch variables.
  652.  
  653.          e.g. Tmodem /B%1 /P%2 /F %3 %4 %5 %6 %7 %8 %9
  654.  
  655.          They may be supplied by any other means at your disposal.
  656.  
  657.                                 Error Levels
  658.  
  659.          I  will  exit,  following the transfer, with  1  of  2  error
  660.          levels.
  661.  
  662.          0 if files were  transferred or received.
  663.          1 if no files or transfers where sent.
  664.  
  665.                                 Debug Messages
  666.  
  667.          Tmodem  will display a number of ERROR messages when  missing
  668.          important or required command line switches.
  669.  
  670.          i.e. Missing or Illegal Baud Rate.
  671.  
  672.          Reference  The  Section(s) of this document  that  deal  with
  673.          that particular command line setting.
  674.  
  675.                              BBS/Terminal Programs
  676.  
  677.          I use a very basic command line setup for Tmodem. This should
  678.          allow it to be used by almost any program.
  679.  
  680.          I do NOT expect that it will work with EVERYTHING.
  681.  
  682.          If  you are using something that it will just flat  not  work
  683.          with then send it to me.
  684.  
  685.          Tmodem v6.20                                          Page 11
  686.  
  687.          You  can upload it or mail it and I will attempt to find  out
  688.          why.
  689.  
  690.                      Installation Setup and Debugging Tips
  691.  
  692.          The  single largest problem with installing Tmodem  has  been
  693.          incorrect  /B  parameters.
  694.  
  695.          I  can not stress this strong  enough.
  696.  
  697.          You  MUST pass the connect baud rate and NOT the LOCKED  baud
  698.          rate.
  699.  
  700.                           Installing Tmodem on A BBS
  701.  
  702.          Make  sure  you read the Tmodem.doc file at least  twice  and
  703.          write  down all the command line switches.
  704.  
  705.          Do  that even if you  don't think  you'll need them  all.  It
  706.          will help a LOT and lowers  the chance that  you may overlook
  707.          that one little  switch  that will make Tmodem work with your
  708.          software.
  709.  
  710.          I had one Pcboard sysop complain that Tmodem just dropped the
  711.          uploads in the current directory.
  712.  
  713.          Pcboard  required the uploads to go to a  SPECIFIC  directory
  714.          and he had to switch to that directory in his batch file.
  715.  
  716.          Had he read the tmodem.doc file, he would have known that  /U
  717.          could have fixed his problem.
  718.  
  719.          You  should NEVER  attempt to install TMODEM as  an  external
  720.          protocol  in  you  terminal software AND on your BBS  at  the
  721.          same time.
  722.  
  723.          You  WILL need to have Tmodem already installed and  debugged
  724.          at  ALL  baud  rates  (if you have a  9600+  modem)  in  your
  725.          terminal package before installing it on your BBS.
  726.  
  727.          Find a BBS that you KNOW has Tmodem installed, correctly, and
  728.          test  your terminal setup. Make sure you test at 2400 and  at
  729.          9600 (if you have  a 9600  baud modem) by transferring  files
  730.          to  and from the  BBS.
  731.  
  732.          Make sure you have it tested both SEND and RECEIVE.
  733.  
  734.          When  it comes time to install Tmodem on your BBS,  you  will
  735.          KNOW which side is not correctly set up.
  736.  
  737.          If you do not know of a BBS that HAS Tmodem set up correctly,
  738.          call 1-314-334-6369.
  739.  
  740.          Tmodem v6.20                                          Page 12
  741.  
  742.                     Installing Tmodem on a Terminal Package
  743.  
  744.          The    first  thing  you do is  to   READ    your    terminal
  745.          programs documentation on HOW to install external programs.
  746.  
  747.          Know EXACTLY HOW  and  WHAT your terminal program passes   in
  748.          respects   to command line arguments. Each  terminal  program
  749.          does  this a little  differently.  Some VERSIONS of the  same
  750.          terminal program do it differently.
  751.  
  752.          Keeping in mind that Tmodem REQUIRES 3 switches.
  753.  
  754.          These two are ALWAYS used in BOTH batch files.
  755.  
  756.          /Bxxxx with xxxx being the CONNECT baud rate
  757.          /Px  with x being the COM Port
  758.  
  759.          Your 3rd REQUIRED switch will vary.
  760.  
  761.          Your Receive batch file will use /R
  762.          Your SEND batch file will use  /F <Filename>
  763.  
  764.                   <Filename> is the NAME of the file to Send.
  765.  
  766.          Your  receive  batch file should also have /K, keep aborted
  767.          transfers. This allows you to RESUME  the transfer at a later
  768.          date.
  769.  
  770.          Most  of You will be using DOS BATCH parameters to pass   the
  771.          information  from  your terminal program to Tmodem.
  772.  
  773.          e.g. Tmodem /K /B%1 /P%2 /R
  774.          e.g. Tmodem /B%1 /P%2 /F %3 %4 %5 %6 %7 %8 %9
  775.  
  776.          The  number  following  the percent sign can  and  will  vary
  777.          depending   on your software. It can also vary  depending  on
  778.          the  version  of your software. That's why I can't  TELL  you
  779.          what  to use for a specific program.
  780.  
  781.          There  is an EASY method you can use to FIGURE all this out.
  782.  
  783.          Place  the following line in both the SEND and RECEIVE  batch
  784.          files.
  785.  
  786.          Echo %1 %2 %3 %4 %5 %6 %7 %8 %9
  787.          pause
  788.          Tmodem <your normal command line>
  789.  
  790.          The line beginning with the 'Echo' will show you exactly WHAT
  791.          your terminal program is passing and in which % variable. You
  792.          can  then  adjust  your command line  so  that  the  REQUIRED
  793.          arguments are supplied by the correct percent variable.
  794.  
  795.          Tmodem v6.20                                          Page 13
  796.  
  797.          The  BIGGEST single problem is passing the CONNECT baud  rate
  798.          to  Tmodem  when  a 9600 baud modem is  used.
  799.  
  800.          Some  Terminal programs (telix for instants) was not  written
  801.          to handle  smart protocols. It will pass the SERIAL baud rate
  802.          instead of  the connect  baud rate which isn't acceptable.
  803.  
  804.          It  is   easy   to  debug  this  problem  using  the    above
  805.          Debugging example. If the %x variable your using to pass  the
  806.          baud  rate contains  9600,  19200, or 38400 when you call   a
  807.          2400  baud system,  then your terminal program wasn't written
  808.          to  handle smart protocols.
  809.  
  810.                    Some  terminal  programs  (Qmodem)  offer
  811.                    your TWO  % variables for baud rate,  one
  812.                    is  the  CONNECT  rate  and  one  is  the
  813.                    SERIAL rate.
  814.  
  815.          The  answer  to  the problem is to Hard code 0 in  as  the  /B
  816.          parameter. I will then prompt you for the connect rate.
  817.  
  818.          e.g. Tmodem /B0 /P%2 /R
  819.  
  820.          Another  common problem associated with high speed modems  is
  821.          not letting me KNOW you have a locked serial port.
  822.  
  823.          Be  sure you set the COMx=LOCKRATE in your  environment.  You
  824.          can  do  that  by  including one of  the  following  in  your
  825.          autoexec.bat  file. Or  on the line  right  before  you  call
  826.          Tmodem.
  827.  
  828.          Select  one of the following that reflects your serial   port
  829.          and lock rate.
  830.  
  831.          SET COM1=9600
  832.          SET COM2=9600
  833.          SET COM3=9600
  834.          SET COM4=9600
  835.          SET COM1=19200
  836.          SET COM2=19200
  837.          SET COM3=19200
  838.          SET COM4=19200
  839.          SET COM1=38400
  840.          SET COM2=38400
  841.          SET COM3=38400
  842.          SET COM4=38400
  843.  
  844.  
  845.          If you have placed the SET command in your AUTOEXEC.BAT file,
  846.          REBOOT your computer so it will take effect.
  847.  
  848.          The next thing you should do is test your setup on a BBS that
  849.          you KNOW has tmodem setup correctly.
  850.          Tmodem v6.20                                          Page 14
  851.  
  852.          I would be very very frustrated to find out that I had  spent
  853.          hours  attempting  to debug my installation only to find  out
  854.          that the problem was on the BBS side.
  855.  
  856.          If you need a BBS to test with, call 1-314-334-6359.
  857.  
  858.  
  859.                          Terminal Interface Examples
  860.  
  861.                                      Telix
  862.  
  863.          If  you have a 300, 1200, or 2400 baud modem you'll need two
  864.          batch files, one to send and one to receive.
  865.  
  866.          Tsend is for Sending file(s) and Trcv.bat is setup to RECEIVE
  867.          files.
  868.  
  869.          Trcv.bat calls Tmodem :
  870.  
  871.          Tmodem -K -UC:\UPLOADS -B%1 -P%2 -R
  872.  
  873.          Notice the -UC:\UPLOADS
  874.  
  875.          This is an optional switch that directs all files received to
  876.          a holding directory called C:\UPLOADS
  877.  
  878.          i.e. Tmodem -K -B%1 -P%2 -R
  879.  
  880.          Trcv.bat calls Tmodem :
  881.  
  882.          Tmodem -B%1 -P%2 -F %3
  883.  
  884.                          Locked Serial Ports and Telix
  885.  
  886.          First  thing  you  do  is set up  a  COMx=LOCK_RATE  in  your
  887.          environment.  Assuming  Com 2 is used and the  lock  rate  is
  888.          19,200 baud.
  889.  
  890.                                 SET COM2=19200
  891.  
  892.          This statement should be placed in your autoexec.bat file and
  893.          will  be used by ALL of OUR protocol drivers.
  894.  
  895.          If you are using Telix with a Fixed DTE rate then you have  a
  896.          problem.
  897.  
  898.          Telix  always passes the SERIAL rate in the %1  variable.
  899.  
  900.          The   fix  is  simply,  but  does   require  that   you   pay
  901.          attention to the CONNECT message  telix  gives you.
  902.  
  903.          You  will need to take Tsend and  Trcv.bat and make a  couple
  904.          of small modifications.
  905.          Tmodem v6.20                                          Page 15
  906.  
  907.          Trcv.bat calls Tmodem :
  908.  
  909.          Tmodem -K -UC:\UPLOADS -B0 -P%2 -R
  910.  
  911.          Notice that the %1 following the -B has been replaced with  a
  912.          0 (zero).
  913.  
  914.          This  tells me that Telix isn't capable  of  passing the TRUE
  915.          connect rate. I will open a small window in the middle of the
  916.          screen displaying  4 connect rate options. You select the one
  917.          that is correct  for the current session.
  918.  
  919.          You  need  to make the same modifications to  the   Tsend.bat
  920.          file.
  921.  
  922.                                     Qmodem
  923.  
  924.                              300/1200/2400 Modems
  925.                 9600 Baud Modem, running a FLOATING serial Port
  926.  
  927.          Qmodem External Download file for Tmodem.
  928.  
  929.          <TDN.BAT>
  930.          Tmodem -B%3 -P%2 -K -R
  931.          Exit
  932.  
  933.  
  934.          Qmodem External Upload file for Tmodem.
  935.  
  936.          <TUP.BAT>
  937.          Tmodem -B%3 -P%2 -F %4
  938.          Exit
  939.  
  940.                  9600 Baud Modem, running a LOCKED Serial Port
  941.  
  942.          Qmodem External Download file for Tmodem.
  943.  
  944.          <TDN.BAT>
  945.          Tmodem -A -B%3 -P%2 -K -R
  946.          Exit
  947.  
  948.  
  949.          Qmodem External Upload file for Tmodem.
  950.  
  951.          <TUP.BAT>
  952.          Tmodem -A -B%3 -P%2 -F %4
  953.          Exit
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.          Tmodem v6.20                                          Page 16
  961.  
  962.                                     QT 2000
  963.  
  964.                           Protocol Definition Record
  965.  
  966.          Send : -B*B -P*P -F *F
  967.          RCV  : -K -B*B -P*P -R
  968.  
  969.                                     NOTICE
  970.  
  971.          I makes no  claims will I accept any  responsibility for the
  972.          accuracy  of the PcBoard examples. They were SUBMITTED by   a
  973.          Pcboard sysop and included  without modifications.
  974.  
  975.                                     Pcboard
  976.  
  977.  
  978.          (PCBRT.BAT)
  979.          echo off
  980.          echo %1 %2 %3 %4
  981.          copy pass.txt pcbpass.txt
  982.          e:
  983.          cd\ed11
  984.          tmodem -B%4 -P1 -R
  985.          cd\
  986.          c:
  987.          cd\pcb
  988.  
  989.  
  990.  
  991.          (PCBST.BAT)
  992.  
  993.          echo off
  994.          echo %1 %2 %3 %4
  995.          tmodem -B%4 -P1 -F %3
  996.  
  997.          I makes no  claims nor will I  accept any  responsibility for
  998.          the   accuracy  of the   SpitFire   examples.   They     were
  999.          SUBMITTED    by  a  SpitFire   sysop   and  included  without
  1000.          modifications.
  1001.  
  1002.  
  1003.                                  SpitFire BBS
  1004.  
  1005.  
  1006.          NOTE the -U Switch, it is -UC:\SF\EXTERNAL
  1007.          DO NOT!!!  ADD ..   IF EXIST %3 ERASE %3  ,IF YOU DO THAT
  1008.          The Files Will Dissapear!...,make SURE the -U Switch
  1009.          is set at -Uc:\sf\EXTERNAL !!!!
  1010.          Tmodem v6.20                                          Page 17
  1011.  
  1012.          (SFEXTUPB.BAT)
  1013.  
  1014.          BRK OFF
  1015.          Echo Off
  1016.          CD\SF\EXTERNAL
  1017.          TMODEM -B%1 -P%2 -UC:\SF\EXTERNAL -R
  1018.          IF ERRORLEVEL 1 GOTO END
  1019.          IF ERRORLEVEL 0 GOTO GOOD
  1020.          GOTO END
  1021.          :GOOD
  1022.          muv %3 %4
  1023.          SFLOGIT        TMODEM used!
  1024.          :END
  1025.          CD\SF
  1026.          BRK ON
  1027.  
  1028.          (SFEXTDNC.BAT)
  1029.  
  1030.          BRK OFF
  1031.          ECHO OFF
  1032.          CD\SF\EXTERNAL
  1033.          TMODEM -B%1 -P%2 -F %3
  1034.          IF ERRORLEVEL 1 GOTO END
  1035.          IF ERRORLEVEL 0 GOTO GOOD
  1036.          GOTO END
  1037.          :GOOD
  1038.          SFLOGIT        Tmodem Used!
  1039.          :END
  1040.          IF EXIST %3 ERASE %3
  1041.          CD\SF
  1042.          BRK ON
  1043.  
  1044.          (SFEXTDND.BAT)
  1045.  
  1046.          Echo Off
  1047.          BRK OFF
  1048.          CD\SF\EXTERNAL
  1049.          TMODEM -B%1 -P%2 -F %3 %4 %5 %6 %7 %8 %9
  1050.          IF ERRORLEVEL 1 GOTO END
  1051.          IF ERRORLEVEL 0 GOTO GOOD
  1052.          GOTO END
  1053.          :GOOD
  1054.          SFLOGIT        Tmodem Used!
  1055.          :END
  1056.          If EXIST %3 ERASE %3
  1057.          IF EXIST %4 ERASE %4
  1058.          IF EXIST %5 ERASE %5
  1059.          IF EXIST %6 ERASE %6
  1060.          IF EXIST %7 ERASE %7
  1061.          IF EXIST %8 ERASE %8
  1062.          IF EXIST %9 ERASE %9
  1063.          CD\SF
  1064.          BRK ON
  1065.          Tmodem v6.20                                          Page 18
  1066.  
  1067.          (SFEXTUP.BBS)
  1068.  
  1069.          <A> ZModem
  1070.          <B> TModem
  1071.          <C> ZModem Batch,Batch
  1072.  
  1073.          (SFEXTDN.BBS)
  1074.  
  1075.          <A> ZModem
  1076.          <B> ZModem Batch,Batch
  1077.          <C> TModem
  1078.          <D> TModem Batch,Batch
  1079.  
  1080.          NOTE: If you install Tmodem on any BBS program not listed and
  1081.          would  like to share your installation setup, type it up  and
  1082.          upload  it to our BBS. We will include it, unaltered, in  the
  1083.          next release of the documentation.
  1084.  
  1085.  
  1086. ****************************************************************************
  1087.                    I M P O R T A N T  S O  R E A D  T H I S !
  1088.  
  1089.                               LIMITED SHAREWARE.
  1090.  
  1091.          Tmodem   is what I refer to as LIMITED SHAREWARE. That  means
  1092.          that you can try almost all the features before you  purchase
  1093.          it.
  1094.  
  1095.                          Features that will not work.
  1096.  
  1097.          Batch  Downloads: You can not RECEIVE Batches of  Files.  You
  1098.          will  be limited to only one file per download. If  you  tell
  1099.          the  BBS  to  send  more than one, only  the  first  will  be
  1100.          accepted.
  1101.  
  1102.          Restart Recover: You may not resume an interrupted transfer.
  1103.          This should NOT be confused with error recover. Resuming an
  1104.          interrupted transfer means picking up on a file you started
  1105.          but was aborted because carrier was lost.
  1106.  
  1107.  
  1108. ****************************************************************************
  1109.  
  1110.                              Registering Tmodem
  1111.  
  1112.                            ($15.00 you download Key)
  1113.               ($25.00 for Disk with Latest Version Mailed to You)
  1114.  
  1115.          Fill out the Order.Frm and Mail To :
  1116.  
  1117.                         International  TeleCommunications
  1118.                              555 North Spring, #39
  1119.                            Cape Girardeau Mo. 63701
  1120.          Tmodem v6.20                                          Page 19
  1121.  
  1122.                               $15.00 Registration
  1123.  
  1124.          You DOWNLOAD the Tmodem.key from the BBS at 1-314-334-6359.
  1125.  
  1126.  
  1127.                               $25.00 Registration
  1128.  
  1129.          We  will   send you the key on a 5 1/2 360K  diskette   along
  1130.          with  the  latest version of Tmodem.
  1131.  
  1132.                                Tmodem License
  1133.  
  1134.                              Please Read Carefully
  1135.  
  1136.          By   registering  Tmodem, you indicate your   acceptance   of
  1137.          these terms.
  1138.  
  1139.          Tmodem   ("the  Software")  is  copyright  1989,  90,  91  by
  1140.          International TeleCommunications and Mike Bryeans.
  1141.  
  1142.          All    rights  are   reserved.    The PURCHASER   is  granted
  1143.          a  LICENSE  to  use the  software   only,  subject   to   the
  1144.          following restrictions and limitations.
  1145.  
  1146.          1. The license is to the original purchaser only, and is  not
  1147.          transferable   without  written  permission  of  Micro   TECH
  1148.          Systems, Inc.
  1149.  
  1150.          2.  The  original purchase may use the Software on  a  single
  1151.          computer or single Local Area Network owned or leased by  the
  1152.          original purchaser.
  1153.  
  1154.          You may not use the software on more than one computer or one
  1155.          Local  Area  Network  even if you own or lease  all  of  them
  1156.          without the written consent.
  1157.  
  1158.          3.  The  original purchaser may make back-up  copies  of  the
  1159.          Software  for  his or her own use only, subject  to  the  use
  1160.          limitations in this license.
  1161.  
  1162.          4. The original purchaser may not engage in, or permit  third
  1163.          parties to engage in, any of the following:
  1164.  
  1165.                    A. Providing or permitting use of or disclosing the
  1166.                    Software to third parties.
  1167.  
  1168.                    B. Making alterations or copies of any kind in  the
  1169.                    Software (except as specifically permitted above).
  1170.  
  1171.          Tmodem v6.20                                          Page 20
  1172.  
  1173.                    C. Attempting to Un-assemble, de-compile or reverse
  1174.                    engineer the Software in any way.
  1175.  
  1176.                    D. Granting sublicenses, leases, or other rights in
  1177.                    the Software to others.
  1178.  
  1179.  
  1180.  
  1181.          International  TeleCommunications   reserves  the  right   to
  1182.          terminate  this license  if there is a violation of its terms
  1183.          or   default  by the  Original Purchaser.  Upon  termination,
  1184.          all  copies of  the Software must be immediately returned  to
  1185.          Micro  TECH  Systems, and  the  Original Purchaser  shall  be
  1186.          liable  to  International TeleCommunications  for any and all
  1187.          damages suffered as a result of  the violation or default.
  1188.  
  1189.